home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Plus Special 26
/
AMIGAplus Sonderheft 26 (2000)(Falke)(DE)(Track 1 of 2)[!].iso
/
Tools
/
GFX-Viewer
/
Animviewer
/
cdxl_datatype
/
cdxl.datatype.doc
< prev
next >
Wrap
Text File
|
1999-03-29
|
7KB
|
196 lines
TABLE OF CONTENTS
cdlx.datatype/MAIN
cdxl.datatype/--datasheed--
cdxl.datatype/--input_format--
cdlx.datatype/MAIN cdlx.datatype/MAIN
INTRODUCTION
REQUIREMENTS
- You need at least Kick/WB 3.0.
| Many people wrote me that they cannot find an
| "animation.datatype" class.
| Only the 3.1 release contains it. (Subclasses of)
| animation.datatype can run under 3.0.
- "datatypes/animation.datatype", >= V39.
"animation.datatype 40.7 (28.09.93)" requires itself some
libraries/boopsi classes:
- "realtime.library", >= V39 - for timing
- "gadgets/tapedeck.gadget" (any version) - for the controls
USAGE
If the datatypes descriptor file was activated, any attempt to load
an CDXL stream using GMultiView, MultiView, AmigaGuide or
SwitchWindow will load and play the movie.
If you want to save the current movie in cdxl.datatype's local
format, use MultiView's "Project/Save As..." menu (or GMultiView's
"Project/Save As Raw...").
cdxl.datatype saves the current movie, stating with the current
frame as a CDXL stream.
(Not implemented yet).
INSTALLATION
After unpacking this archive:
Because this version does not include an Installer script, you have
to do the installation manually through the shell:
- Unpack this archive and copy the "cdxl.datatype" to
SYS:Classes/DataTypes:
Copy CLONE FROM "cdxl.datatype" TO "SYS:Classes/DataTypes/cdxl.datatype"
- Then copy the datatypes descriptor into the DEVS:DataTypes
directory.
If the descriptor already exists, you should not replace it,
otherwise you may loose "toolnodes" and other settings stored in
the existing descriptor.
Copy CLONE FROM "CDXL(%|.info)" TO DEVS:Datatypes/
SOURCE
Partial source is included as an KISS example how to write an
animation.datatype subclass.
AUTHOR
If you want to blame me, report any bugs, or wants a new version
send your letter to:
Roland Mainz
Hohenstaufenstraße 8
52388 Nörvenich
GERMANY
Phone: (+49)(0)2426/901568
Fax: (+49)(0)2426/901569
EMAIL is also available (if you want to send me attachments
larger than 1MB (up to 5MB, more with my permission):
GISBURN@w-specht.rhein-ruhr.de
Up to April 1998 I'm reachable using this email address, too:
Reinhold.A.Mainz@KBV.DE
| Please put your name and address in your mails !
| German mailers should add their phone numbers.
| See BUGS section above when submitting bug reports.
Sorry, but I can only look once a week for mails.
If you don't hear something from me within three weeks, please
send your mail again (but watch about new releases) (problems with
this email port are caused by reconfigurations, hackers, network
problems etc.).
The entire "cdxl.datatype" package may be noncommercially
redistributed, provided that the package is always distributed
in it's complete form (including it's documentation). A small
copy fee for media costs is okay but any kind of commercial
distribution is strictly forbidden without my permission !
Comments and suggestions how to improve this program are
generally appreciated!
Thanks to David Junod, who wrote the animation.datatype and lots of
the datatypes example code, Matt Dillon for his DICE, Olaf 'Olsen'
Barthel for his help, ideas and some text clips from his
documentations.
cdxl.datatype/--datasheed-- cdxl.datatype/--datasheed--
NAME
cdxl.datatype -- data type for CDXL movies
SUPERCLASS
animation.datatype
DESCRIPTION
The cdxl datatype, a sub-class of the animation.datatype, is used to
load and play CDXL movies.
METHODS
OM_NEW -- Create a new movie object from a description file. The
source may be a file or you may create an empty object (DTST_RAM).
OM_DISPOSE -- Dispose instance and contents (frames, colormaps, sounds
etc.), then pass msg to superclass.
OM_UPDATE -- Perform an ICM_CHECKLOOP check, and if succesfull, the
method will be executed like OM_SET downstairs.
OM_SET -- Pass msg to superclass and call GM_RENDER if retval from
superclass was != 0UL.
DTM_WRITE -- Save object's contents in local (CDXL) or
superclass (IFF ILBM) format.
(Encoder not implemented yet).
ADTM_START -- Start playback. cdxl.datatype prepares itself to start
at the given timestamp and then passes the msg to superclass.
ADTM_LOADFRAME -- Fill in struct adtFrame with requested information
from internal FrameNode list like bitmap, colormap and sample. If
the bitmap information is not loaded yet, it will be loaded from
disk.
ADTM_UNLOADFRAME -- Free resources obtained by ADTM_UNLOADFRAME.
All other methods are passed unchanged to superclass.
ATTRIBUTES
Following attributes are set by the object and are READ-ONLY for
applications:
DTA_ObjName -- set by file name (same as DTA_Name)
DTA_TotalVert -- set by PAN section
DTA_TotalHoriz -- set by PAN section
ADTA_Width -- set by PAN section
ADTA_Height -- set by PAN section
ADTA_Depth -- set by PAN section
ADTA_ModeID -- set by PAN section
ADTA_Frames -- number of frames in the movie
ADTA_FramesPerSecond -- FPS rate
ADTA_KeyFrame -- Key frame of movie
BUGS
None known yet.
TODO
- Fixing the bugs above.
- Write the "--input_format--"-Autodoc section.
HISTORY
V1.1
Released to the Waldspecht-BBS for testing.
V1.2
- Fixed the bug that ADTM_START/ADTM_LOADFRAME seek'ed outside
the file bounds if a alf_TimeStamp larger than ADTA_NumFrames
was given. Now both methods does bounds checking and
in the case of ADTM_LOADFRAME alf_Frame returns the timestamp
which was really loaded.
Fixed.
SEE ALSO
animation.datatype,
mpegsystem.datatype, mpegvideo.datatype,
picmovie.datatype,
anim.datatype. avi.datatype, quicktime.datatype,
moviesetter.datatype,
film.datatype,
directory.datatype,
markabletextdtclass
cdxl.datatype/--input_format-- cdxl.datatype/--input_format--
NAME
CDXL --
DESCRIPTION
<Not written yet, sorry>
SEE ALSO